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1. Introduction 

This RC-SDK 8.0 API Reference, Part III Development Edition describes the functions used to develop 
RAW data and convert it to JPEG and other formats. RAW is one type of image data format of Canon digital 
camera, and no image processing is performed on it within the camera. It is data recorded from the captured 
pixels as is. RAW image data formats include cdFORMATRAW and cdFORMAT_RAW_SPATIAL data. 
You can discover the data format by examining the basic image data properties. 



1.1 RAW Data Formats 

The fonnat of the RAW data depends on the model of the camera used to take the picture. Some of the 
development parameter types and values that can be set may differ depending on the camera model. Therefore, 
to set development parameters or convert the RAW data to develop it, you must first retrieve and evaluate the 
format of the RAW data. 

There are different variations on RAW file. RAW file format is distinguished by the extension of the file name. 
The image files that have an extension of CRW. TIF and CR2 are just the RAW image data. 





Table 1-lExtention and Camera Model 


Extension 


Camera Model 


CRW 


D30, D60, 10D, Kiss Digital, D300, Digital Rebel 


TIFF 


1D, IDs 


CR2 


1DMarkll,20D, IDs Mark II 



1.2 Setting Development parameter 

When you develop RAW data, you can change the development parameters, including the application of a 
filter or the white balance setting. The functions given here are for setting development parameters. However, 
note that non-supported functions and values that can be set may differ depending upon the RAW development 
faculty value. 

To set development parameters and develop the data, execute these functions, make the settings in the RC-SDK, 
and then execute the RCDevelopQ function described later that develops the RAW data. 
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2. Overview 

This chapter describes overview of the functions used for RAW development process. There are many 
functions related to RAW development process, so they are divided into the following groups for purposes of 
description 



RAW object create/dispose Functions 

• RCCreateRAWObject 

• RCDisposeRAWObject 

Get available development parameter item 

• RCIsSuportParamltem 

• RCGetSupportParamltemHead 

• RCGetSupportParamltemNext 

Get available development value 

• RCIsSupportParamValue 

• RCSupportParamValueHead 

• RCSupportParamValueNext 

Get/Set current development parameter 

• RCGetParamValue 

• RCSetParamValue 

• RCSetAllParamValueToAtCapture 

• RCCopyClickWBCoefs 

Development process 

• RCDevelop 

Get development parameter and update image data 

• RCWriteDevParamToRaw 

• RCCopyRawObjPrmToStgMedium 

• RCCopyStgMediumPrmToRawObj 

Memory utility function 

• RCUnFocusRAWObject 
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3. Data Type Definition 
3.1 Basic 

The definition of the parameter related to RAW development is described to rcType.h. The old definition 
value described in cdType.h camiot be used in RCSDK. 

The cdStgMedium structure is a generalized memory handle used for deta transfer operations by the RCSDK 
interface. 



3.2 Output file format 

The header file rcType.h has data type definition used by only RCDevelop function. 



Typedef cdUIntS cdDevTgtFormat 



#define cdTGT_FORMAT_JPEG 
#define cdTGT_FORMAT_PIXMAP 
#define cdTGT_FORMAT_JPEG_EXIF 
#define cdTGT_F0RMAT_PIXMAP_16 
#define cdTGT_FORMAT_TIFF_EXIF 
#define cdTGT_FORMAT_TIFF 
#define cdTGT_FORAMT_BMP 
#define cdTGT FORMAT BMP TOPDOWM 



13 
14 
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4. Design of this document 

This API reference has the following format in each RC-SDK API. 

4.1 Function Name 



Description 

Describes the detail of API. 



Syntax 



Adopts the expression of C language in function definition 

[Type of return value] [Calling rules] [Function name (parameter type parameter name ... ) 



Parameters 

Parameter and parameter type to call the API 



Return Values 

Specify the value that API terminates and returns. 



See Also 



Note 



Referential section of the API (Option) 



Handling instruction (Option) 
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5. Raw object handling 

This section introduces the functions used for basic operations, such as initiating RAW development. 

5.1 RCCreateRAWObject 

Description This function creates a RAW object that is associated with the specified cdStgMedium 

structure. The client needs the RAW object when using each development API. 
The client should use RCDisposeRAWObject to dispose a Raw Object. 



Syntax 



Parameters 

pStgMedium 

phRAW 



cdCAPI RCCreateRAWObject( 

CdStgMedium* pStgMedium, cdHRAW * phRAW ) 



cdStgMedium*; specify the pointer to cdStgMedium structure. 

cdHRAW*; specify the pointer to the RAW handle that this fimction returns RAW object 
handle into the address specified by this parameter. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdNOT SUPPORTED 


Not Support 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 



5.2 RCDisposeRAWObject 

Description This function disposes the specified RAW object. 



Syntax 

Parameters 

hRAW 



CdCAPI RCGDisposeRAWObject ( cdHRAW hRAW ) 



cdHRAW; specify the handle of RAW object 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 
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6. Available development parameter item 

This section describes the functions used to get the available development parameter items. 

6.1 RCIsSupportParamltem 

Description This function determines whether the RAW object can set the specified development 

parameter item. 



Syntax 



cdCAPI RCIsSupportParamItem( cdHRAW hRAW, 

cdDevTParamltemID prmID, cdDevTAvailablity* pAvailable ) 



Parameter 

hRAW 

prmID 



cdHRAW; specify the handle of the RAW object 
cdDevTParamltemID; specify the ID of development parameter item. 



Value 


Meaning 


kPrmID 16bitLinear 


16bit linear 


kPrmlD_DgtlExpCmp 


Digital exposure compensasion 


kPrmID LightSrc 


Light source of white balance 


kPrmID PosClickWB 


Click white balance coordinates 


kPrmlD_ColorTemp 


Color temperature 


kPrmlD_MgGr 


White Balance shift Magenta-Green 


kPrmID AmBI 


White balance shift Amber-Blue 


kPrmID WBCoeffs 


White Balance Coeffs 


kPrmID Contrast 


Contrast 


kPrmID CIrTone 


Hue 


kPrmID Saturation 


Saturation 


kPrmlD_Sharpness 


Sharpness 


kPrmlD_SharpnessTarget 


Target applied to sharpness 


kPrmlD_ColorSpace 


Color space 


kPrmID ColorMatrix 


Color matrix{for 1 D/1 Ds/1 D Mark 11/1 Ds Mark II) 


kPrmID ColorEffect 


Color Effect 


kPrmlD_4ptRGBToneCurve 


RGB Tone curve: 4Points{for id/ids) 


kPrmlD_12ptRGBToneCurve 


RGB Tone curve: 1 2Points(for 1 D Mark Ii/1 Ds Mark ii) 



pAvailable cdDevTAvailability* ; pointer to cdDevTAvailablity variable that this function returns 

status into the address specified this parameter, if this prmID parameter item is available. 



Value 



Meaning 



kDev_NotSupported 
kDev AvailableToSet 



Not supported in this camera model 
Available 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 
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cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



6.2 RCGetSupportParamltemHead 

Description This function gets the settable development parameter items to the specified RAW object. 

To get the follow-on development parameter items after retrieving parameter item by 
calling RCGetSupportParamltemHeadQ , call RCGetSupportParamltemNextQ. 



Syntax 



Parameter 

hRAW 

pPrmID 



cdCAPI RCGetSupportParamltemHead ( cdHRAW hRAW, 
cdDevT ParamltemID* pPrmID ) 



cdHRAW; specify the handle of the RAW object 

cdDevTParamltemID*; specify the pointer to ID of development parameter item. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdlNVALID PARAMETER 


Parameter error 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 



6.3 RCGetSupportParamltemNext 

Description 



This function gets the follow-on settable development parameter items to the specified 
RAW object. In the case that the development parameter item is not exist any more, this 
function returns kPrmID Invalid. 



Syntax 



cdCAPI RCGetSupportParamltemNext ( cdHRAW hRAW, 
cdDevT ParamltemID* pPrmID ) 



Parameters 

hRAW 

pPrmID 



cdHRAW; specify the handle of the RAW object 

cdDevTParamltemID*; specify the pointer to ID of development parameter item. 



Returns 



cdError: cdOK if successful; othenvise, the return value is one of the bellow error list. 



Error Type 


Comments 


RCINVALID PARAMETER 


Invalid parameter entered. 
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RCINVALID HANDLE 


hSource is invalid handle. 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 
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7. Available development parameter value 

This section provides the functions related to retrieve the development parameter values. 

7.1 RCIsSupportParamValue 

Description This function determines whether the RAW object can set the specified development 

parameter value. 



Syntax 



Parameter 

hRAW 

prmID 

prmVal 

pAvailable 



cdCAPI RCIsSupportParamValue( cdHRAW hRAW, 
cdDevTParamltemID prmID, 

cdDevTRawPrmVals prmVal, 

cdDevTAvailbility* pAvailable ) 



cdHRAW; specify the handle of the RAW object 

cdDevTParamltemID ; specify the ID of development parameter item. 

cdDevTRawPrmVals ; speicify patameter value to be checked 

cdDevTAvailability* ; pointer to cdDevTAvailablity variable that this function returns 
status into the address specified this parameter if this prmID parameter item is available. 



Returns 



cdError: cdOK if successful; othenvise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



7.2 RCGetSupportParamValueHead 

Description 



This function gets the settable development parameter values to the specified RAW object. 
To get the follow-on development parameter value after retrieving parameter value by 
calling RCGetSupportParamValueHeadQ , call RCGetSupportParamValueNext(). 



Syntax 

Parameter 

hRAW 

PrmID 
pPrmVal 



CdCAPI RCGetSupportParamValueHead ( cdHRAW hRAW, 

cdDevT ParamltemID PrmID, cdDevT RawPrmVals* pPrmVal ) 



cdHRAW; specify the handle of the RAW object 
cdDevTParamltemID; specify the ID of development parameter item. 
CdDevTRawPrmVals*; specify the pointer to variable to be stored as development 
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Returns 



parameter value. 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



7.3 RCGetSupportParamValueNext 

Description 



This function gets the follow-on settable development parameter value to the specified 
RAW object. In the case that the development parameter value is not exist any more, this 
function returns kPrmVal Invalid. 



Syntax 

Parameter 

hRAW 

PrmID 
pPrmVal 



cdCAPI RCGetSupportParamValueNext ( cdHRAW hRAW, 

cdDevT ParamltemID PrmID, cdDevT RawPrmVals* pPrmVal ) 



cdHRAW; specify the handle of the RAW object 

cdDevTParamltemID; specify the ID of development parameter item. 

cdDevTRawPrmVals*; specify the pointer to variable to be stored as development 
parameter value. 



Returns 



See Also 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdlNVALID PARAMETER 


Parameter error 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 



RCGetSupportParamValueHead 
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8. Development parameter Settings 

This section introduces the functions related to set/get the development parameter. 

8.1 RCGetParamValue 

Description This function retrieves the specified development parameter value. 



Syntax 



cdCAPI RCGetParamValue( cdHRAW hRAW, 

cdDevTPrmKind prmKind, 

cdDevTParamltemID prmID, 

cdDevT_RawPrmVals* pGetValue ) 



Parameter 

hRAW 

prmKind 



cdHRAW: A handle for the RAW object. 

cdDevTPrmKind ; specify the kind of parameter value to be get. 



Value 



Meaning 





kPrmKindAtCapture 
kPrmKindCurrentSetting 
kPrmKindSupportMin Value 
kPrmKindSupportMax Value 
kPrmKindStandardValue 
kPrmKind_DevelopSetting 




setting as shot 

current setting 

minimum value to be supported 

maximum value to be supported 

standard value 

current develop setting 


prmID 


cdDevTParamltemID; specify the 


IE 


) of development parameter item. 


pGetValue 


cdDevTRawPrmVals* ;specify 


the 


pointer to variable to be store 



parameter value. 

This value changes with development parameter items. 

In the case that prmID is kPrmID_4ptRGBToneCurve, parameter value is the pointer to 
cdDevT_4PointsRGB structure. 

In the case that prmID is kPrmID_I2ptRGBToneCurve, parameter values is the pointer to 
cdDevT_12PointsRGB structure. 

Otherwise, parameter values is the pointer to type of cdUInt32 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



See Also 



RCSetParam Value 
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8.2 RCSetParamValue 

Description 



This function sets the specified development parameter value. Note that calling 
RCReflectParamValuesO in order to making a setup reflect, before calling RCDevelopQ. 

The client can get available parameter by calling RCGetSupportParamValueHeadQ and 
RCGetSupportParamValueNextQ. Furthermore, the client can determine whether the 
parameter is available by using RClsSupportParamValueQ- 



Syntax 



Parameter 

hRAW 

prmlD 
prmValue 



cdCAPI RCSetParamValue( cdHRAW hRAW, 
cdDevTParamltemID prmID, 
cdDevTRawPrmVals prmVal ) 



cdHRAW: A handle for the RAW object. 

cdDevTParamltemID ; specify the ID of development parameter item. 

cdDevTRawPrmVals ; specify the value of development parameter value 



Returns 



See Also 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



RCRefrectParam Values 



8.3 RCSetAIIParamValueToAtCapture 

Description This function resets the current development parameter values to shot setting. 



Syntax 

Parameter 

hRAW 



CdCAPI RCSetAllParamValueToAtCapture( cdHRAW hRAW ) 



cdHRAW; A handle for the RAW object. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 
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8.4 RCCopyClickWBCoefs 

Description When the client set a Click White Balance Value by calling RCSetParam Value functoin, 

the RAW object holds it. The client should call this function to copy the curret parameter 
value to other RAW object. 

It needs that t\vo RAW objects are generated from the same camera model. 



Syntax 

Parameter 

hRAWSrc 

hRAWTgt 



cdCAPI RCECopyClickWBCoefs( cdHRAW hRAWSrc, cdHRAW hRAWTgt ) 

cdHSource; A handle for source RAW object. 
cdHSource; A handle for target RAW object 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdMEM ALLOC FAILED 


Memory allocation error 



8.5 RCReflectParamValues 



Description The RAW object is maintaining the status of two parameters; the parameters for Ul, and the 

parameters for development. This function reflects one status to another. 
The RAW object holds the status of the parameter for Ul in the case of setting the 
parameter by calling RCSetParam ValueQ. To develop with these setting parameters, the 
client should call this function before calling RCDevelopQ- 



Syntax 



Parameter 

hRAW 

CopyDir 



CdCAPI RCReflectParamValues( cdHRAW hRAW, 
cdDevTParamCopyDirection CopyDir) 



cdHRAW; specify the handle of the RAW object 
cdDevTParamCopy Direction; direction flag of parameter reflecting 
Value Meaning 



kPrmCpyUI2Dvlp 
kPrmCpyDvlp2UI 



Reflect the parameters for Ul to the parameters 
for development 

Reflect the parameters for development to the 
parameters for Ul 
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Returns 



cdError: cdOK if successful; othenvise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdNOT SUPPORTED 


Not Support 
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9. Raw Development 

This chapter presents the function that executes development for RAW data. 



9.1 RCDevelop 

Description 



This function develops the specified RAW object with the current development parameters. 
To reflect the values to be set by RCSetParamValueQ, call RCReflectParamValuesQ. 



Syntax 



Parameter 

hRAW 

Action 



cdCAPI RCDevelop( cdHRAW 

cdDevTDev Action 

cdDevTgtFormat 

cdDevTDimension 

cdStgMedium* 

cdProgressCallbackFunction* 

cdContext 

cdProgressOption 



cdHRAW: A handle for the RAW object. 
cdDevTDev Action ; specify the action of development. 



hRAW 

Action, 

tgtFormat, 

AreaAndRatio, 

pStgMedium, 

pCallbackFunc, 

Context, 

ProgressOption ) 



Value 



Meaning 



kDevAct_FullDevelop 

kDevAct_PrevDevelop 

kDevAct_ThumbDevelop 



Full size development 
Reduction size development 
Thumbnail size development 



TgtFormat 



cdDevTgtFormat ; specify the format of development target. 



Value 



Meaning 



cdTGT_FORMAT_PIXMAP PIXMAP 

cdTGT_F0RMAT_PIXMAP_1 6 1 6bit Pixmap 

cdTGT_FORMAT_BMP Bitmap 

cdTGT_FORMAT_BMP_TOPDOWN TOP DOWN Bitmap 



AreaAndRatio 

pStgMedium 
pCallbackFunc 
Context 
ProgressOption 



cdDevTDimension ; specify the pointer to cdDevTDimension structure. 
The client can specify the area and the reduction ratio into this structure. 

cdStgMedium* ; specify the pointer to cdStgMedium structure. 

cdProgressCallbackFunction ; specify the address of a callback function. 

cdContext ; specify the context 

cdProgressOption ; specify the option for progress callback. 



cdDevT Dimension Structure 
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typedef struc 


t{ 




cdRect 




DevelopArea; 


cdlnt32 




ReductNumerator; 


cdSize 




DeveloppedSize; 


} cdDevT Dimension; 



Member 

DevelopArea 



The rectangle of the image area which is developed. The coordinate at the upper left of 
image is (0,0). 



ReductNumerator specify the denominator of the reduction ratio as kReductDenominator. 
DeveloppedSize the return value is the size of developed image. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNAVLID PARAMETER 


Invalid parameter 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 
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10. Get development parameter and Update image 

This section provides the functions used to write the development parameter in RAW data and retrieved the 
development parameter from RAW data. 



10.1 RCWriteDevParamToRAW 

Description 



This function writes the development parameter values to be set in RAW object into the 
specified storage. The specified storage needs to associate with the same camera model as 
the storage of the RAW object. 



Syntax 

Parameter 

hRAW 

pReflect 



cdCAPI RCWriteDevParamToRAW( cdHRAW hRAW, cdStgMedium* pReflect ) 

cdHRAW: A handle for the RAW object. 

cdStgMedium* ; specify the pointer to cdStgMedium structure. 



Returns 



cdError: cdOK if successful; othenvise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



10.2 RCCopyRawObjPrmToStgMedium 

Description This function writes the current development parameter values into the specified storage. 

The client can set the development parameter value of a RAW object as the one of other 
RAW objects by calling RCCopyStgMediumPrmToRawObjO. 



Syntax 



Parameter 

hRAW 

pTargetStg 



CdCAPI RCCopyRawObjPrmToStgMedium ( cdHRAW hRAW, 
CdStgMedium* pTargetStg ) 



cdHRAW; A handle for the RAW object. 

cdStgMedium*; specify the pointer to cdStgMedium structure. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdlNVALID PARAMETER 


Parameter error 
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cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



10.3 RCCopyStgMediumPrmToRawObj 

Description This function sets the development parameter value of the Raw object which is retrived by 

calling RCCopyRawObjPrmToStgMediumQ into the the specified RAW object. 



Syntax 



Parameter 

pStgMedium 

hTargetRaw 



cdCAPI RCCopyStgMediumPrmToRawObj( cdStgMedium* pStgMedium, 
cdHRAW hTargetRaw ) 



cdStgMedium*; specify the pointer to cdStgMedium structure. 
cdHRAW; A handle for the open device. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 



10.4 RCWriteParamValueFile 

Description 



This function writes the client specified development parameter values into the specified 
storage. 



Syntax 



Parameter 

hRAW 
PrmlD 



CdCAPI RCWriteParamValueFile ( cdHRAW hRAW, 

cdDevT ParamltemID PrmID, 

CdStgMedium* pDst) 



cdHRAW; A handle for the RAW object. 

cdDevTParamltemlD; specify the ID of development parameter item. 

Only specification of the parameter below the present condition is possible. 



Value 



Meaning 



kPrmlD_WBCoeffs 

kPrmlD_4ptRGBToneCurve 

kPrmlD_12ptRGBToneCurve 



WB Coefficients 
4PT RGB Tone Curve 
12PTRGB Tone Curve 



Revision History /Date 


Corrections 


Reviser 


Remarks 











































Copyright © 2004 Canon Inc. 



Canon 



RCSDK API Programming Reference 



ID 



RCSDK-DEV 



Page 



19 



pDst 
Returns 



cdStgMedium* ; specify the pointer to cdStgMedium structure. 

cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdlNVALID PARAMETER 


Parameter error 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 



10.5 RCReadParamValueFile 

Description 



This function sets the development parameter value of the Raw object which is retrived by 
calling RCWriteParamValueFile () into the the specified RAW object. 



Syntax 



Parameter 

pSrc 

PrmlD 



cdCAPI RCReadParamValueFile ( cdStgMedium* 

cdDevT ParamltemID 
cdHRAW 



cdStgMedium* ; specify the pointer to cdStgMedium structure. 



pSrc, 

PrmID, 

hRAW) 



cdDevTParamltemlD; specify the ID of development parameter item. 
Only specification of the parameter below the present condition is possible. 



Value 



Meaning 



kPrmlD_WBCoeffs 

kPrmlD_4ptRGBToneCurve 

kPrmlD_12ptRGBToneCurve 



WB Coefficients 
4PT RGB Tone Curve 
12PTRGB Tone Curve 



hRAW 
Returns 



cdHRAW: A handle for the RAW object. 

cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


CdlNVALID HANDLE 


Invalid handle 


CdlNVALID PARAMETER 


Parameter error 


CdMEM ALLOC FAILED 


Memory allocation error 


CdNOT SUPPORTED 


Not Support 
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11. Memory Utility 

This section describes the functions to use a memory effectively. 



11.1 RCUnFocusRAWObject 

Description This function releases only the resource that the specified RAW object allocates. Resources 

such as intermediate data are allocated to the RAW object by RCDevelopQ and some 
functions. So the client must call this function in order to release the resources. 



Syntax 



cdCAPI RCUnFocusRAWObject( cdHRAW hRAW) 



Parameter 

hRAW 



cdHRAW: A handle for the RAW object. 



Returns 



cdError: cdOK if successful; otherwise, the return value is one of the bellow error list. 



Error Type 


Comments 


cdlNVALID HANDLE 


Invalid handle 


cdMEM ALLOC FAILED 


Memory allocation error 


cdNOT SUPPORTED 


Not Support 
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